home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 6 / CU Amiga Magazine's Super CD-ROM 06 (1996)(EMAP Images)(GB)(Track 1 of 4)[!][issue 1997-01].iso / cucd / online / fidonetts / fsc-0071.001 < prev    next >
Text File  |  1993-01-17  |  13KB  |  286 lines
  1. Document: FSC-0071
  2. Version:  001
  3. Date:     17-Jan-1993
  4.  
  5.  
  6.  
  7.  
  8.                   Distributed FREQ (DFREQ) Specifications
  9.                       Bill Auclair, FidoNet 1:141/545
  10.                             January 17, 1993
  11.  
  12.  
  13.  
  14.  
  15. Status of this document:
  16.  
  17.      This FSC suggests a proposed protocol for the FidoNet(r) community,
  18.      and requests discussion and suggestions for improvements.
  19.      Distribution of this document is unlimited.
  20.  
  21.      Fido and FidoNet are registered marks of Tom Jennings and Fido
  22.      Software.
  23.  
  24.  
  25.  
  26.  
  27.        Distributed File Requests:  What Are They?
  28.        ------------------------------------------
  29.  
  30.          DFREQ programs are designed to allow both sysops and  users
  31.          to  make Distributed File Requests from other  BBS  systems
  32.          listed in FidoNet<tm> or compatible nodelists.   There  are
  33.          several major differences between Distributed File  Request
  34.          methodology (hereafter referred to as DFREQ)  and  existing
  35.          FidoNet FREQ and/or file distribution formats.
  36.  
  37.          FidoNet file request technology was designed only  for  the
  38.          direct  transmittal of file requests  from  one  system  to
  39.          another.   DFREQ technology allows routing of file requests
  40.          from  the  originating  system  along  a  user-configurable
  41.          "chain" of systems,   ending at  the  target  node.    This
  42.          methodology  allows the setup of  no-cost,   local  routing
  43.          paths for  file requests between distant systems that would
  44.          normally  incur long-distance phone charges.
  45.  
  46.  
  47.  
  48.        How DFREQs Work
  49.        ---------------
  50.  
  51.          Distributed File Request methodology can be separated  into
  52.          2 main parts-- the REQUEST and the ACKNOWLEDGEMENT.
  53.  
  54.          The  REQUEST represents the initial stage,  in which  DFREQ
  55.          data  from the originating system has not yet  reached  its
  56.          target,  and thus carries no accompanying  requested  files
  57.          with  it.   DFREQ data may be relayed via file  or  netmail
  58.          message attach through any number of  intermediate  systems
  59.          on its way to its ultimate target,  which is defined by the
  60.          contents  of the request  file.   The  path  taken  by  the
  61.          request to its target is determined by routing data used by
  62.          the DFREQ processors of participating nodes in the chain.
  63.  
  64.          The ACKNOWLEDGEMENT is the result of a  processed  request,
  65.          and  is created whether or  not  the  requested  files  are
  66.          available  at the target  system.   The  DFREQ  information
  67.          formerly  carried by the request  is  used  to  create  the
  68.          acknowledgement,  set   its   destination   back   to   the
  69.          originating system, file- or netmail-attach requested files
  70.          (if any) for transmission, and/or provide information as to
  71.          why  requested  file(s)  were  unavailable  at  the  target
  72.          system.  Request data is deleted by the target system after
  73.          the  acknowledgement is created.   The path  taken  by  the
  74.          acknowledgement  back  to  the  originating  system   again
  75.          depends upon the routing configurations of the chain nodes,
  76.          but need not be the same as the path  previously  travelled
  77.          by the request.
  78.  
  79.          ASCII  text files are used to transport  DFREQ  information
  80.          between nodes.  These carrier files are similar in form and
  81.          function to the .TIC files used by the TICK<tm>  file  echo
  82.          utility.
  83.  
  84.          The DFREQ process starts when a user generates a  DFR  file
  85.          containing  file request information,  using the  local  or
  86.          on-line mode of a DFREQ processor.
  87.  
  88.  
  89.  
  90.        DFR Files
  91.        ---------
  92.  
  93.          DFREQ  data for the REQUEST stage is  transmitted  using  a
  94.          file with a .DFR (Distributed File Request) extension.  The
  95.          filename is a randomly-generated 8-digit number.  DFR files
  96.          carry  information  on  the  net/node  of  the  originating
  97.          system, net/node of the target system, the name of the user
  98.          who originated the request,  the filenames and descriptions
  99.          of  the files to be requested,  the path travelled  by  the
  100.          request  on its way to the  target  system,  and  date/time
  101.          stamps  indicating when the request was processed  by  each
  102.          node in the path.  DFRs are transmitted via file or netmail
  103.          message attach.
  104.  
  105.  
  106.  
  107.        DFA Files
  108.        ---------
  109.  
  110.          DFREQ  data for the ACKNOWLEDGEMENT  phase  is  transmitted
  111.          using a file with a .DFA (Distributed File Acknowledgement)
  112.          extension.   The  8-digit  filename   of   the   previously
  113.          processed  DFR request file is retained.   DFA files  carry
  114.          information  on the  net/node  of  the  originating  system
  115.          (formerly the target system in the DFR file),  the net/node
  116.          of  the target system (formerly the originating  system  in
  117.          the  DFR file),  the name of the  user  who  generated  the
  118.          request,  the filenames and  descriptions  of  successfully
  119.          requested  files,  and the filenames and  associated  error
  120.          information for any unsuccessfully requested or unavailable
  121.          files.   The full  path  information  from  the  previously
  122.          processed DFR file is retained,  and is appended with  path
  123.          and  datestamp information representing the travel  of  the
  124.          DFA file back to its new target, the source of the original
  125.          DFREQ.  DFAs are transmitted via file or netmail attach.
  126.  
  127.  
  128.  
  129.        Error Messages
  130.        --------------
  131.  
  132.          When  requests for any or all files in a DFREQ can  not  be
  133.          fulfilled  for some  reason,  information  as  to  why  the
  134.          request  was not satisfied is included  in  the  DFA  file,
  135.          replacing the file descriptions of the  unavailable  files.
  136.          Reasons for file unavailability can include:
  137.  
  138.  
  139.           o  File(s) not found or not available at target system
  140.  
  141.           o  OKFile path does not exist on target system
  142.  
  143.           o  File(s) not found in inbound area-- node xxx/xxx
  144.  
  145.  
  146.          DFA  files may be appended with error  information  by  any
  147.          processing  system in the chain  back  to  the  originating
  148.          node, depending upon where the error condition occurs.
  149.  
  150.  
  151.  
  152.        DFR/DFA File Formats
  153.        --------------------
  154.  
  155.          DFR and DFA files are ASCII text files that transport DFREQ
  156.          information between systems.   The DFR file is used  during
  157.          the REQUEST stage of the transaction.  The DFA file is used
  158.          during the ACKNOWLEDGEMENT stage of the transaction.
  159.  
  160.          New  DFR files are created by the DFREQ processor using its
  161.          local  or on-line user  mode.   A  random  8-digit  numeric
  162.          filename and .DFR extension are assigned to the file.  File
  163.          format for a newly-created DFR is shown below:
  164.  
  165.  
  166.          Created by  GOFER v0.05a, Copyright (C) 1992 by Bill Auclair
  167.          Origin      141/545
  168.          Requestor   Bill Auclair
  169.          Target      141/455
  170.          File        LOGON.LZH 2969 01-17-90 generic telix log-on script
  171.  
  172.  
  173.          The first line of the DFR holds information identifying the
  174.          program/version  used to create it.   No empty  spaces  are
  175.          allowed above this line,  or between any of the lines  that
  176.          follow.
  177.  
  178.          The  second line of the DFR  contains  Origin  information.
  179.          This  indicates the net/node number  of  the  system  which
  180.          generated the DFR.
  181.  
  182.          The third line of the DFR contains  Requestor  information.
  183.          This provides the name of the user who initiated the DFREQ.
  184.  
  185.          The  fourth line of the DFR  contains  Target  information.
  186.          This indicates the net/node number of the system  which  is
  187.          to  receive the DFR and process  it  to  deliver  requested
  188.          files.
  189.  
  190.          All  lines beginning with  the  "File"  identifier  contain
  191.          filename and description information taken from remote file
  192.          lists.   Filenames and descriptions must be separated by at
  193.          least one space.  No empty lines are allowed after File
  194.          information.
  195.  
  196.          When  a DFR  is  sent  to  another  system,  that  system's
  197.          net/node information is appended to it, along with date and
  198.          time  stamp  information  indicating  when  the   DFR   was
  199.          processed by the system.   This information accompanies the
  200.          DFR  throughout its entire journey.   A DFR file with  Path
  201.          information appended to it is shown below:
  202.  
  203.  
  204.          Created by  GOFER v0.05a, Copyright (C) 1992 by Bill Auclair
  205.          Origin      141/545
  206.          Requestor   Bill Auclair
  207.          Target      141/455
  208.          File        LOGON.LZH 2969 01-17-90 generic telix log-on script
  209.          Path        141/507   15 Nov 92 07:40:31
  210.  
  211.  
  212.          Information contained within the DFR file  above  indicates
  213.          it  has already traveled through  the  intermediate  system
  214.          141/507  on its way from Origin system  141/545  to  Target
  215.          system 141/455.  No empty lines are allowed after Path
  216.          information.
  217.  
  218.          When  a DFR file reaches  its  Target  destination,  it  is
  219.          converted  into a DFA  file,  and  its  file  requests  are
  220.          evaluated by the target system.  Conversion of DFRs to DFAs
  221.          is  done by retaining the DFR filename,  changing the  .DFR
  222.          extension  to .DFA,  and reversing Origin and Target  data.
  223.          Thus,  a DFR file originally named 12345678.DFR from Origin
  224.          141/545 for Target 141/455 becomes 12345678.DFA from Origin
  225.          141/455 for Target 141/545, as shown below:
  226.  
  227.  
  228.          Created by  GOFER v0.05a, Copyright (C) 1992 by Bill Auclair
  229.          Origin      141/455
  230.          Requestor   Bill Auclair
  231.          Target      141/545
  232.          File        LOGON.LZH 2969 01-17-90 generic telix log-on script
  233.          Path        141/507   15 Nov 92 07:40:31
  234.          Path        141/485   15 Nov 92 08:02:55
  235.          Path        141/455   15 Nov 92 08:15:23
  236.          Path        141/455   15 Nov 92 08:15:25
  237.  
  238.  
  239.          Note the dual Path lines for the Target system.   The first
  240.          line represents processing as a DFR,  the second represents
  241.          processing as a DFA.
  242.  
  243.          The  successfully-processed DFA file  is  returned  to  the
  244.          system  that  originated  the   DFREQ,   along   with   the
  245.          accompanying  requested file.   The  DFA  as  received  and
  246.          processed by the originating system is shown below:
  247.  
  248.  
  249.          Created by  GOFER v0.05a, Copyright (C) 1992 by Bill Auclair
  250.          Origin      141/455
  251.          Requestor   Bill Auclair
  252.          Target      141/545
  253.          File        LOGON.LZH 2969 01-17-90 generic telix log-on script
  254.          Path        141/507   15 Nov 92 07:40:31
  255.          Path        141/485   15 Nov 92 08:02:55
  256.          Path        141/455   15 Nov 92 08:15:23
  257.          Path        141/455   15 Nov 92 08:15:25
  258.          Path        141/485   15 Nov 92 10:01:06
  259.          Path        141/507   15 Nov 92 10:27:35
  260.          Path        141/545   15 Nov 92 10:31:59
  261.  
  262.  
  263.          If the Target system receiving the DFR file cannot  satisfy
  264.          the  DFREQ,  the file description for the unavailable  file
  265.          contained  in  the  new  DFA   is   replaced   with   error
  266.          information.   The DFA is  then  transmitted  back  to  the
  267.          system  that  originated  the  DFREQ.   Error   information
  268.          contained  within  the  DFA  file  as   returned   to   the
  269.          originating system is shown below:
  270.  
  271.  
  272.          Created by  GOFER v0.05a, Copyright (C) 1992 by Bill Auclair
  273.          Origin      141/455
  274.          Requestor   Bill Auclair
  275.          Target      141/545
  276.          File        LOGON.LZH !ERR018! File Not Available From 141/455
  277.          Path        141/507   15 Nov 92 07:40:31
  278.          Path        141/485   15 Nov 92 08:02:55
  279.          Path        141/455   15 Nov 92 08:15:23
  280.          Path        141/455   15 Nov 92 08:15:25
  281.          Path        141/485   15 Nov 92 10:01:06
  282.          Path        141/507   15 Nov 92 10:27:35
  283.          Path        141/545   15 Nov 92 10:31:59
  284.  
  285. 
  286.